iSleep 2.3 (for very busy users: read only what's in red)
	
For OS X 10.2 or later, works with iTunes 3, Whamb and DVD Player 3.2 and above
(Won't work on earlier versions of Mac OS X. An older free version, iSleep 1.5b, is still available on the web site)

Thank you for downloading iSleep! In this new and improved version, you are allowed 30 days to try before you buy. If you like iSleep and wish to continue using it after the 30 day trial period, please register at the following URL for only 8 USD:
http://flymac.nerim.net/store.html
If you prefer, you can send me a check via normal snail mail (please email me to get the address), but only if you are able to write checks in Euros please. Don't forget to include your e-mail address on a sheet of paper!
Future updates will be FREE for registered users, and you will get a discount on any of my future shareware applications! 
Please don't forget to write your email in the Kagi form, as I will mail you back with the Serial Number.

NEW Whamb + iSleep bundle offer: as Whamb (see http://www.whamb.com for more info), the revolutionary MP3 player and iSleep work together we thought a bundle offer may interest you. Whamb costs 12,5$ as single license, and iSleep 8$, so 20,5$ for both. What if you could buy both for only 15$? Guess, we made it! Check out my online store at the above adress. Just a precision: I can't be taken as responsible for any problem you may have with Whamb, it is a partnership and thus I don't provide technical support for Whamb, please refer to me only regarding iSleep.

What does iSleep 2.3 do ?

iSleep 2 is now split into three functional modes: iTunes, Whamb or DVD player. All modes work in the same way. You select the number of minutes you want to let iSleep count down, and then perform a selected action to iTunes, Whamb or DVD player.
iSleep features also an alarm clock, which will makes iTunes or Whamb to play at a selected date with a fade in effect. iSleep can even wake up your Mac from sleep mode and begin playing music !

For iTunes, Whamb and DVD Player, the actions available are as follows:
- Stop the player (and wake you up if desired)
- Stop the player & Quit iSleep
- Quit the player 
- Quit the player & Quit iSleep
- Put the computer to sleep (and wake you up if desired, please see below for important notes)
- Log out
- Restart
- Shut Down the computer (see below for important notes)
(For DVD, perform any of the above actions when the movie has finished playing, iSleep manages it for you)

How do I use iSleep?

Here is a basic guide to using iSleep. Open the application to continue.

If you are not registered, you will see the "Shareware Window" first, click "Close Window" to go to the main iSleep window.

The first field from the top is the time in minutes until the fade out begins and the desired action occurs. On its right, you see the check box that enables this option in DVD Player mode.

Just below on the left, there is a reminder of the selected option. On the right, the status bar shows the remaining time. The stop button in the middle gets enabled when you begin the count down, with the button on its right, named "Go To Bed".

On the bottom, the Show Options button (looks like an "eject" button on your CD player) opens a Drawer. The "Volume to step" is the value of the volume that will be deducted every time the volume changes. Set it  to "1 %" to get a very long fade out, and "10%" to decrease volume more abruptly.

On the right, you will see "Seconds between volume changes". This works with the previous option, it represents the amount of time between each decreasing volume step.  Set it to "1" for a very quick fade out, and to "10" for a longer fadeout.
On the bottom are the available options. I think they are self-explanatory :-)

Note that the fade out values are not present in DVD Player mode. All preferences are saved on quit.

To switch between iTunes, Whamb and DVD Player functions, simply choose the desired option in the "Mode" menu bar. DVD Player mode won't be available if you do not have "DVD Player.app" installed in the Applications folder (DVD Player is installed by default if a DVD drive is present). For Whamb, it will automatically be enabled if you have "Whamb" in the Applications folder. If you have it but installed it somewhere else, just check the corresponding box in the Preferences (not recommended).

IMPORTANT NOTE: the alarm clock is available with the "Stop iTunes" option when using iTunes mode (the same applies to Whamb). In DVD mode, only the 3 first options are compatible. 
iSleep can now put you Mac to sleep after the fade out and wake it up when specified and begin playing music !
To use the alarm clock, simply enter a date and time (time is saved but date is always set to the current date (+ 1 day if launched before midnight or after 5 AM)) and check the box. If you use the "Put Macintosh to Sleep" function it will prompt you for your administrator password (only the first time when launched) as this is required to set the wake up time. Make sure it is correct or it will not wake you up but it should warn if you if the pass is incorrect.

To allow you to choose how loud you want to be waked up, select "Preferences" in the Application's Menu and select what fits best to you. You can also set the fade in time: the volume will begin with 0 and increase until it reaches the volume it was set to before. If in DVD Player mode, also choose which player you want for wake up.

Click "Go To Bed" and enjoy your music while falling asleep. iSleep will care for the rest. Please read the DVD limitations below.

Some limitations / things you should know:

- In case of Shut Down, Restart and Log Out, make sure nothing will stop the process, such as an unsaved document. 

- For the alarm clock: it is finally possible to wake up the Mac from sleep at a specified time, this function has been tested on these Macs yet: Titanium 550 & 667, iMac DV, ibook 600 and Cube 450 mhz. Old World machine may be incompatible with this function, depending on your firmware version. If it doesn't work, please just let me know. In any case, I recommend using a real Alarm clock the first time, just to be sure you'll be up on time.
If you wake up your Mac manually after iSleep did with Alarm Clock function enabled, the timing is disabled and it will not wake up the Mac, you have to let run it again (of course if the Mac remains on and running when it is time to wake up, it will work, but not when in sleep mode).

For the iTunes and Whamb mode:
- Make sure you have iTunes/Whamb running when launching the software, altrough it will start it up and begin playing automatically when you press "Go To Bed".

For the DVD Player mode:
- In "Wait for the movie to end" mode, press Go To bed only after the film really begins, because the film extras that play before the main menu of a DVD would bring iSleep to perform the action even before the main menu, because these are considered as movie. Go to the main menu of the DVD, press play, return to iSleep, press Go To Bed, make the DVD full screen if wanted and that's all, enjoy!
- If you selected the "Wait for the movie to end" option, the action occurs a few seconds before the real end of the movie, because of a little error tolerance in the "remaining seconds" in the DVD Player AppleScript dictionary. It is safer to do so, because some movies have a bad timecoding and the direct action may never occur.

- As said before, you can choose which player to use for waking you up in the Preferences.

- To uninstall, just trash the application (urg!) and remove the preferences file (~/Library/Preferences/iSleep.plist).

Troobleshooting

Why isn't DVD Player mode available to me ?
iSleep checks if an application called "DVD Player" exists in the "/Applications/" folder of your hard disk. It's installed if you have a DVD Player by default, so it should be there if you didn't move/rename it. Make sure it is there and correctly named. Note that obviously, it won't work if you don't have a DVD Player at all.

Please e-mail flymac@lostzone.net if you experience any problems.

What's new in version 2.3 ?
- I/O Kit integration enabling the machine to wake up from sleep
- Increased waiting time until fade out to 600 minutes
- Misc. little improvements

What was new in 2.2 ?
- Added Whamb mode (mp3 player)
- Fade in for the alarm clock
- Small interface enhancements

What was new in 2.1 ?
- Alarm clock function
- French Localization
- Preferences Window
- Added "Log Out" and "Restart" options.
- Interface slightly modified

What was new in 2.0 ?
- Completely rewritten from scratch in Objective-C Cocoa
- Prefs are now saved in a clean .plist file
- It is now (only) Jaguar compatible and works with iTunes 3
- DVD Player support added
- Won't ask for an admin password anymore!
- "Check for updates" menu item
- iSleep is now shareware

What was new in 1.5b ?
Almost everything ! No more "stack overflow" bug, less CPU usage (!), a preferences file to remember the window position, and all your settings. The interface is new, too, thanks to Edouard Puginier for his wonderful work on photoshop. Of course, you have a lot more options available too. The volume will start from where is it (and not 100% anymore, sorry guys) and will be reset after the fade out is over. Consider it as the first "real" release :)

iSleep 1.1b - original release.

------------

Don't hesitate to mail me, there may be bugs or thinks to improve, just drop me a note :)

That's all, enjoy it and... have wonderful dreams !

FlyMac		 & 	Tazintosh 
Coder			Interface layout, web site, intensive testing, icon design
flymac@lostzone.net		tazintosh@mac.com

Credits:
Thanks a lot to Édouard Puginier (aka "Tazintosh") for designing the icon, the interface, the web site and for his testing and overall support, and to Bob for his help (testing, code improvements in iSleep 1.5b) ! 
Thanks to Jeb, mbuna, Philou, beeloo and MikeOSX for testing and general support!
Thanks to Thomas and nl for helping me with Cocoa!
Thanks to Jose Cerritelli and the El Gato software for the I/O Kit tip!
Thanks also to the people @ Cocoa-Dev mailing-list.

Check out #mac-fr on UnderNet, IRC :-)

© 2001-2003 FlyMac.

Common legalese: I'm not responsible in any way for any damage of any kind due to the use of this software, etc, ah, you know all that already. You can distribute the software freely as long as it is the original .sit file. Please contact me if you want to distribute it somewhere else than on the Internet (CD...).